Query

Cette classe est utilisée pour construire et exécuter des requêtes SQL.

Propriétés

  • private array $parameters : Le tableau qui contient les paramètres de la requête.

Méthodes

clone()

public function clone()

Description

Clone la requête.

Retour

  • Query : La requête clonée.

compile()

public function compile()

Description

Compile la chaîne de requête. Cette méthode doit être implémentée par les classes enfants.

Retour

  • string : La chaîne de requête compilée.

Exceptions

  • Lance une exception si la méthode n'est pas implémentée par les classes enfants.

sanitize(string $sql): string

protected function sanitize(string $sql): string

Description

Assainit la requête SQL.

Paramètres

  • string $sql : La requête SQL à assainir.

Retour

  • string : La requête SQL assainie.

addParameter(string $name, mixed $parameter): static

public function addParameter(string $name, mixed $parameter): static

Description

Ajoute un paramètre à la requête. Méthode chaînable.

Paramètres

  • string $name : Le nom du paramètre.
  • mixed $parameter : Le paramètre à ajouter.

Retour

  • Query : Cette instance.

Exceptions

  • Lance une exception si le paramètre existe déjà.

addParameters(array $parameters): static

public function addParameters(array $parameters): static

Description

Ajoute plusieurs paramètres à la requête.

Paramètres

  • array $parameters : Un tableau de paramètres à ajouter à la requête.

Retour

  • Query : Cette instance.

setParameter(string $name, mixed $parameter)

public function setParameter(string $name, mixed $parameter)

Description

Définit un paramètre dans la requête. Méthode chaînable.

Paramètres

  • string $name : Le nom du paramètre.
  • mixed $parameter : Le paramètre à définir.

Retour

  • Query : Cette instance.

Exceptions

  • Lance une exception si le paramètre n'existe pas.

getParameter(string $name)

public function getParameter(string $name)

Description

Récupère un paramètre de la requête.

Paramètres

  • string $name : Le nom du paramètre.

Retour

  • mixed : Le paramètre, ou null s'il n'existe pas.

hasParameter(string $name)

public function hasParameter(string $name)

Description

Vérifie si un paramètre existe.

Paramètres

  • string $name : Le nom du paramètre.

Retour

  • bool : Retourne true si le paramètre existe, sinon false.

setParameters(array $parameters)

public function setParameters(array $parameters)

Description

Définit les paramètres de la requête. Méthode chaînable.

Paramètres

  • array $parameters : Les paramètres à définir.

Retour

  • Query : Cette instance.

getParameters()

public function getParameters()

Description

Récupère les paramètres de la requête.

Retour

  • array : Les paramètres de la requête.

prefixParameter(string $name)

private function prefixParameter(string $name)

Description

Préfixe un paramètre avec un deux-points.

Paramètres

  • string $name : Le nom du paramètre.

Retour

  • string : Le paramètre préfixé.

execute()

public function execute()

Description

Exécute la requête. Cette méthode doit être implémentée par les classes enfants.

Retour

  • mixed : Le résultat de la requête.

unsafeInterpolate(): string

public function unsafeInterpolate(): string

Description

Effectue une interpolation non sécurisée. Cette méthode est utilisée pour effectuer une interpolation non sécurisée, ce qui peut potentiellement mener à des attaques par injection SQL. Il est recommandé d'utiliser la méthode execute() à la place, qui offre une protection contre les injections SQL. Cette méthode peut être utilisée à des fins de débogage.

Retour

  • string : La requête SQL interpolée.